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along with the machines that it will operate on, so that Zedcor may, 
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NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER IS ADVISED 
TO TEST ZBasic™ THOROUGHLY BEFORE RELYING ON IT. THE USER MUST ASSUME THE 
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TERMINATION OF LICENSE 

Any breach of one or more of the provisions of this agreement by me shall constitute an immediate 
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provisions of the agreement which protect the rights of Zedcor Incorporated shall remain in force. 
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Notes on this version of ZBasic 3.0 



MEMORY ZBasic 3.0 for the TRS-80 models 1 & 3 is designed to run with both 

the TRS-80 mode! 1 under TRSDOS 2.3 or compatibles, and the 
TRS-80 model 3 TRSDOS v1 .3 or Compatible DOS. The typical 
programming area available in a 48k machine is aproximately 21.5k 
with the resulting code and variable area being up to 38k. This 
version also has the capability of doing OVERLAYS which are 
explained later in this Appendix. 

FILENAMES The filenames in ZBasic are the standard TRSDOS filenames 

specified in the TRSDOS manual. Some examples are as follows: 

ZBASIC/CMD, PROGRAM/BAS:!, MYPROG/BAS : . SECRET 

RENAME Does not function with this version. 

SOUND Will use the cassette port to do sound if available. Connect a Radio 

Shack apmplifier to the cassette port for sound output. 

MODE 8 to 15 Will use the Radio Shack 640x240 high resolution graphics 

board if available (Micro-Labs also). 



MOUSE 



Does not function with this version. 



KEYS 


Up arrow 




— > 


List previous line 




Down arrow 




— > 


List next line 




Left arrow 




— > 


List first line 




Right arrow 




— > 


List last line 




/ 




— > 


List next 10 lines 




<SHIFT> up , 


arrow 


— > 


ESCape 


HELP FILE 


The file used 


in the ZB 


asic HELP command is calle 



This file can be deleted to allow more room on the disk, in which 
case typing HELP from the editor will generate a "FILE NOT 
FOUND" error. 
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Executing ZBasic from TRSDOS 

Jfc »^iW/?r2)i5/( use cortue&T <*A) mooelUL^ 

There are basically two ways of starting ZBasic from the operating system: 

1. Type: ZBASIC <ENTER> 

This is the standard way to startup ZBasic. See "GETTING STARTED" in 
the ZBasic standard manual. Also see "TRSDOS CONFIGURATION" in 
this appendix. 

2. Type: ZWARM <ENTER> 

This is a special way to startup ZBasic to recover a ZBasic text program 
after a crash or reset (To restart a program like BASIC*). A version of 
ZBasic must be created using the <W>arm start creator option from the 
ZBasic start up screen. 

To Create this WARM start version configure ZBasic for your machine 
and save using the <S>ave option from the ZBasic startup menu. (DO 
NOT use your MASTER DISK only use a BACKUP COPY of your master 
diskette). 

Exit ZBasic using QUIT and re-enter the just created configured ZBasic 
and use the <W>arm Start Creator option to create a WARM start version 
of ZBasic to be called ZWARM/CMD which can be used to recover 
ZBasic program text after a RESET or program lock-up. 

The ZWARM version on the disk can only recover the program if it is still 
intact in memory and has not been overwritten by itself or another 
program. This cannot recover from a program NEW as it destroys the 
program in memory. 

The ZBasic 3.0 patch option allows the user to PATCH specific 
addresses in ZBasic to Change areas in the JUMP TABLE for special 
hardware or software and to apply fixes to the actual program as 
specified by Zedcor to provide some special features. These changes 
may be save by using the <S>ave option from the start-up MENU. 
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TRSDOS CONFIGURATION 

After typing "C" in the initial prompt screen, ZBasic will ask for the standard 
configuration parameters explained in the "GETTING STARTED" section of the 
manual. Following these standard parameters are the TRSDOS specific 
configuration parameters. The additional prompts displayed are as follows: 

Default Clear nnnnn Size 03E8 01000 ? 

This Configuration selects the default amount of memory to be set aside for 
strings in the INDEX$ area at compile time. The actual amount of memory in the 
running compiled program can be found by using MEM function in the program. 
If this area becomes less than or equal to zero due to high memory drivers a 
'Not Enough Memory' error will be displayed and the program will exit back to 
DOS. 

List First Line <Key> 0019 00025 

This key when pressed as the first key on a line will cause the ZBasic editor to 
LIST the first program line in memory and make it the current line. (Defaults to 
the <SHIFT> Left arrow Key). 

List Last Line <Key> 01 2C 00300 

This key when pressed as the first key on a line will cause the ZBasic editor to 
LIST the last program line in memory and make it the current line. (Defaults to 
the Right arrow Key). 

List Previous Line <Key> 01 2C 00300 

This key when pressed as the first key on a line will cause the ZBasic editor to 
LIST the previous program line in memory and make it the current line. 
(Defaults to the Up Arrow Key). 

List Next Line <Key> 01 2C 00300 

This key when pressed as the first key on a line will cause the ZBasic editor to 
List the next program line in memory and make it the current line. (Defaults to 
the Down Arrow Key). 
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Configuration: (cont.) 

Find Next occurrence <Key> 003B 00059 

This key when pressed as the first key on a line will cause the ZBasic editor to Find the 
next occurrence of the string last used in FIND in memory a make it the current line ( 
Defaults to the *;' key (semi-colon)). 



TRSDOS or Other type <T/0> 01 2C 00300 

t-/a//o 

This special Configuration is needed to tell the ZBasic EDITOR which type of DOS you 
are using so the DIR command will be available from the editor. Type a "T" if you are 
using TRSDOS. Type an "O" if using any other DOS. If it is not configured correctly a 
system crash may occur when DIR is used from the editor. This is one of those things 
in machine language that was never truly standardized by TRSDOS and OTHERS. 

DIR does not function from the ZBasic editor with Model 1 TRSDOS 
Most other Model 1 DOSes like •" > , LDOS, MultiDOS etc., will. 

/V fa* A3euJ&o$ SO £*0 

Overlay Offset (See Appendix): 00000 00000 ? 

Allows you to set the Offset for overlay programs. See OVERLAYS. 



id- 
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MEMORY CONSIDERATIONS 



The TRSDOS version of ZBasic has three different modes of operation 
concerning memory organization -- EDIT mode, RUN mode, and RUN* mode 
(see memory map on following page). At least 32k of memory is required for the 
EDIT and RUN modes (the development stage of the program). However, after 
a program has been compiled and saved using RUN*, it can be run on as little 
as 16k of memory depending on the size of the program (the RUN* mode 
shown on the memory map). 



NOTES ON THE ZBasic™ MEMORY MAP: 

1 . The system top of memory is obeyed by ZBasic 3.0 in both the editor and 
object code files. The CLEAR area in the /CMD file created by ZBasic is 
the only area of the compiled program which can adjust to different sizes 
of high memory drivers or machine language routines. If this area is too 
small when an attempt is made to execute this program from DOS a "Not 
Enough Memory" error will occur and it will return to DOS. 

2. The ZBasic subroutines and jump tables are not saved to disk when a 
program is compiled as a chain file using RUN+. Thus, chain files take 
up 10k less on disk. 

3. ZBasic is located immediately after the DOS. There may be drivers or 
other applications installed at the top of memory. ZBasic does, however, 
assume to own all of the memory from DOS to the TOP of memory as 
defined by the DOS. 

4. The size of the INDEX$ is determined by the CLEAR statement (see 
reference section in main manual). The TRSDOS version of ZBasic 
defaults to CLEAR 1000, making the INDEX$ equal to 1k. If there is not 
enough memory to create a CLEAR of the size specified, then the largest 
size available will be allocated. The size of the INDEX$ memory can be 
determined using the MEM function within the running program. 

5. When the CALL string statement is used to execute a DOS function 
(see this appendix under "CALL statement"), the DOS function must not 
use the area where ZBasic resides else a system crash may occur (This 
DOS function jump vector is located in the ZBasic jump table so it may be 
re-vectored for different DOS'es). 
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MEMORY MAP 



Edit Mode 



Run Mode 



RUN * / + 
Program 



FFFF/65535 



Overlay 
Program(s) 




BASE ADDRESSES 



CPM80 2.2 or 3.0 0100 HEX OR 256 DECIMAL 
TRS80 Model 1 or 3 5200 HEX OR 21976 DECIMAL 
TRS80 Model 4 ver.6.2 3000 HEX OR 12288 DECIMAL 



*TopRam is the highest RAM address the system will 
allow ZBasic to use. This address varies from system 
to system and even on the same system!. The INDEX$ 
CLEAR area is the only area of ZBasic that can adjust 
to this area if not enough room is allocated. When the 
object code is executed, a "Not Enough Memory" error 
will occur and the object code will stop and return to the 
operating system. MEM will return memory for INDEX$. 



K\\\WN Memory available 

for ZBasic and ZBasic 
Object Code. 
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RS-232 COMMUNICATION 



ZBasic for the TRS-80 Model I and III supports asynchronous communication 
using the filenumber #-1 for the TRS-80 standard serial Interface. Baud rate, 
parity, stop bits, and word length are all controlled in the OPEN "C" statement 
(see "REFERENCE SECTION" in main manual). 

The serial interface should work properly on most TRS-80 compatibles. 



RS-232 PROBLEMS 

If the asynchronous communication is not working, try any of the following: 

1. Check to make sure the baud rate, parity, stop bits, and word length settings 
are the same on both sides of the communication. 

2. Check for proper cable wiring. The cable must support the standard RS-232 
asynchronous interface. If the serial transfer works at a low baud rate (like 
300 baud) but fails at higher baud rates, the cable is wired improperly. 

The diagrams on the next page show the two most typical cable 
configurations. The top diagram is for communication between two DTE's 
(Data Terminal Equipment) or two DCE's (Data Communication Equipment). 
The diagram below it is for communication between a DTE and a DCE. 
These cable configurations are not the "rule", they are only the most typical 
for proper RS-232 interfacing. 
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ZBasic TRS-80™ Model I, III APPENDIX 



RS-232 : (cont.) 



Communication devices: DTE <— -> DTE 

DCE <— -> DCE 



CONNECTOR 1 



Transmit Data 

Receive Data 

Request to Send 

Clear to Send 

Data Set Ready 

Ground 

Carrier Detect 

Data Terminal Ready 



CONNECTOR 2 



PIN 

2 

3 
4 
5 
6 
7 
8 

20 








PIN 

2 

3 
4 
5 
6 
7 
8 

20 


X 




X 








1 


• < 


I 



Transmit Data 
Receive Data 
Request to Send 
Clear to Send 
Data Set Ready 
Ground 
Carrier Detect 

Data Terminal Ready 



Communication devices: DTE < — > DCE 

DCE <-— > DTE 



CONNECTOR 1 



CONNECTOR 2 



Transmit Data 


PIN 

2 
3 
4 
5 
6 
7 
8 

20 








PIN 

2 

3 
4 
5 
6 

7 
8 

20 


Receive Data 




Request to Send 




Clear to Send 




Data Set Ready 
Ground 






















t Terminal Ready 















Transmit Data 
Receive Data 
Request to Send 
Clear to Send 
Data Set Ready 
Ground 
Carrier Detect 

Data Terminal Ready 
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ZBasic JUMP TABLE 



The TRSDOS version of ZBasic makes available a jump table starting at 
address 5200 hex. These jumps can be altered to jump to some other routine to 
handle the same function. This can be useful for implementing special 
hardware or for handling non-compatible DOS or HARDWARE. Also included 
in this jump table are the USR function jumps, many of which are predifined. 
The following is a list of all the available jump locations with a short description 
of each: 



XX=01 for CPM80 2.2 & 3.0 

XX=30 for TRS-80 Model 4 TRSDOS/LDOS 6.2 

XX=52 for TRS-80 Model 1 and 3 versions 



Address 


Vec 


tors 


xxoo 


JP 


SUBRTN 


XX03 


JP 


WARM 


XX06 


JP 


EXIT 


XX09 


JP 


CHRINP 


xxoc 


JP 


VIDOUT 


XXOF 


JP 


LPROUT 


XX12 


JP 


SCANKY 


XX15 


JP 


ICOMM 


XX18 


JP 


BAUD 


XX1B 


JP 


PARITY 


XX1E 


JP 


STOPBT 


XX21 


JP 


WORDLN 


XX24 


JP 


RSREAD 


XX27 


JP 


RSWRT 


XX2A 


JP 


RSSCAN 


XX2D 


JP 


TIME 


XX30 


JP 


DATE 


XX33 


JP 


PRINTA 


XX36 


JP 


PRINTG 


XX39 


JP 


SOUND 


XX3C 


JP 


MOUSE 


XX3F 


JP 


CONVXY 


XX42 


JP 


MODE 


XX45 


JP 


COLOR 


XX48 


JP 


SETXY 


XX4B 


JP 


PLOTXY 


XX4E 


JP 


FILLXY 


XX51 


JP 


POINT 


XX54 


JP 


DOSCALL 



Description 



Cold Start entry point 
Warm Start entry point 
Exit to System 
Get Keyboard Character 
Output Character to display 
Output character to printer 
Get Key from kybrd no waiting 
INITIALIZE RS232 PORT 
SET RS232 BAUD RATE 
SET RS232 PARITY 
SET RS232 STOP BITS 
SET RS232 WORD LENGTH 
READ 1 CHAR FROM RS232 
WRITE 1 CHAR TO RS232 
GET RS232 CHR NO WAIT 
GET TIME STRING 
GET DATE STRING 
PRINT @(X,Y) ROUTINE 
PRINT %(X,Y) GRAPHIC 
GENERATE SOUND 
READ MOUSE STATUS 
CONVERT GRAPHIC POS 
SET GRAPHICS MODE 
SET COLOR FOR GRAPHICS 
SET POINT DE.HL 
PLOT FROM LAST POINT TO 
FILL FROM POINT 
READ COLOR AT POINT 
CALL DOS COMMAND 



Special Notes ('Save registers!!! 

NONE 

NONE 

NONE 

* RETURNS KEY IN A 

* SENDS CHAR IN A 

* SENDS CHAR IN A 

* A-0 NO KEY ELSE A=KEY 

Set Bd.Par.Stop bits.Wrd len UART 

HL-BAUD RATE 300, 1 200.. 

HL-PARITYO.1.2... 

HL-STOP BITS 0.1,2... 

HL=WORD LEN 5,6,7,8... 

*On exit A=char from rs-232 set Z flag 

*A=CHAR TO SEND set Z flag on exit 

* A=0 NO Char,Z flag set else A=CHAR 

ON Exit HL >-> 9 bytes: len,H,H,:,M,M,:,S,S 

ON Exit HL>-> 9 bytes: len,M,M,/,D,D,/,Y f Y 

HL*Y,DE=X SET CURSOR for next character 

Loc HL«Y,DE=X set cursor for next character 

HL=DURATDN MS.DE-FREQ in HZ 

HL=TYPE RETURNS IN HL 

HL-Y,DE=X RETURN IN HL.DE 

HUMODE # 

HL-COLOR 

LOCAL COORDINATES 

DE.HL LOCAL 

DE.HL FILL AREA around X.Y 

DE.HL RETURNS HL-COLOR 

HL >— > STRING 
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JUMP TABLE: (cont.) 
Default USR functions table 



XX=01 for CPM80 2.2 & 3.0 

XX=30 for TRS-80 Model 4 TRSDOS/LDOS 6.2 

XX=52 for TRS-80 Model 1 and 3 versions 



USR d\g\t(expression ) 



On Entry: expression >==> Z80 reg. HL 

On Exit: HL reg. returned in the expression which contained the USR function. 



XX57 


JP 


USRO 


XX5A 


JP 


USR1 


XX5D 


JP 


USR2 


XX60 


JP 


USR3 


XX63 


JP 


USR4 


XX66 


JP 


USR5 


XX69 


JP 


USR6 


XX6C 


JP 


USR7 


XX6F 


JP 


USR8 


XX72 


JP 


USR9 



HL ON COLD START ENTRY 



OLD HL RETURNS 

RETURN 

RETURN 

RETURN 

RETURN 

RETURN 

RETURNS LAST LINE # EXECUTED WITH TRON ACTIVE 

RETURNS RAW RANDOM # TO 65535 

RETURNS SIN OF HL IN BRADS AS A VALUE OF +/- 256 

RETURNS COS OF HL IN BRADS AS A VALUE OF +/- 256 



Special strings and constants 

These Strings and constants may be changed by POKES or using the PATCH function from the MENU. 



XX80 CLSSTR 

XX84 PRNTAM 

XX8A CUROFF 

XX8E CURON 

XX92 CLRLINE 

XX96 CLRPAGE 

XX9A PAGEO 

XX9B PAGE1 

XX9C PAGE2 

XX9D PAGE3 



4 BYTE CLEAR SCREEN STRING 

6 BYTE PRINT AT CONTROL STRING <ESC>,<=>,Y + 32,X + 32,0,0 

(TRS-80 versions 1st 2 bytes are RS232 config bytes) 

4 BYTE CURSOR OFF STRING 

4 BYTE CURSOR ON STRING 

4 BYTE CLEAR TO END OF LINE STRING 

4 BYTE CLEAR TO END OF PAGE STRING 

1 BYTE PRINTED LINES PER PAGE (0=disabled) 

1 BYTE TOP MARGIN (0=none) 

1 BYTE ACTUAL PAGE LENGTH IN LINES (0=disabled) 

1 BYTE PRESENT LINE (line#1=0,line#2=1....) 



Other important Addresses 



XXAO TO XXBF 
XXOO +200H 



> User area for PATCHES (Saved with <s> config option) 

> 256 buffer (O.K. to use whole buffer during machine language routine) 



ZBasic TRS-80 Appendix - 14 



ZBasic TRS-80™ Model I, III APPENDIX 



OVERLAYS 

ZBasic 3.0 on Z80 based computers allows for Overlays to be used to make 
the most efficient use of a systems available memory. 

An Overlay is a program which is loaded from disk (without destroying the 
program in memory) and executed. After it is executed, it will RETURN to the 
main program. As long as it is in memory it may be called over and over 
again by RUN 0(zero) until it is overwritten by another overlay or program. 

The main advantage of Overlays is they are small and will normally load up 
quickly. After they have been loaded, they work like a GOSUB with the 
variables being chained that appear in the DIM statements at the start of the 
main program and the overlay program. 

Here are the steps in creating an overlay program. 

#1 . Create the MAIN program and define the Overlay subroutine(s). 
#2. To determine th e OFFSET for the overlay subroutine: 

A Type run+ from the MAIN program 
(type <enter> when it asks for a filename) 

B. Type: mem 

00000 Text 

ooooo Memory < — This is the available room for the overlay, 
ooooo object <--- This PLUS 100= OFFSET amount. 

00000 Variable 

The number after "Object" +100 is what is used in the <C>onfigure 
startup to create the OFFSET for the overlay program. 

#3 Set up all variables which will be used by the Overlay program in 
identical DIM statements at the start of both the MAIN program and 
OVERLAY subroutines. 

#4 Compile and save the MAIN program using the RUN* command. 

#5 Compile and save the OVERLAY subroutine using RUN+. 

#6 When the MAIN program requires the use of the overlay use: 

OPEN"I", 1, "overlay filename" and USe RUN 1 to execute 

the overlay subroutine the 1st time. 

#7 After the overlay is loaded it may be executed again without reloading 
the OVERLAY by using the RUN (zero) statement. 
See the OVERLAY program examples on the next page... 
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MAIN Program 



2BASIC<cr> 
(in configure) 
OVERLAY OFFSET = 

ZBasic Ready 

00010 CLEAR 5000 : DIM E,X,Y, Z,TS 

00020 PRINT "STARTING MAIN PGM" 

00030 OPSN"I", 1, "PGMOVL" 

00040 PRINT "GOING TO OVERLAY" 

00050 E=0 : RON 1 

000 60 PRINT "BACK FROM OVERLAY" 

00070 E=l : RUN 

00080 E=2 : Y=l : Z=8 : RUN 

00090 E=3 : RUN 

00100 PRINT "T$='";TS; 

00110 STOP 



<cr> don't Save Object!!! 

MEM 

00217 Text 

Memory 

00200 Object 

06000 Variable 

R UN* (TRSDOS) (CPM80) 

Object File.. MAIN/CMD or MAIN.COM 

MEM 

00217 Text 

Memory 

11000 Object >==> (size on disk) 
06000 Variable 

QUIT<cr> 

(Compile overlay program) 



OVERLAY Program 



ZBASIC<cr> 

(in configure All Else Same') 
OVERLAY OFFSET = 200+256 (aprox) 
E = 456 

ZBasic Ready 

00010 CLEAR 5000 : DIM E,X,Y,Z,T$ 

00020 IF E=0 THEN PRINT "OVERLAY" 

00030 ON E GOTO "HELLO", "TEST", 120 

0004 PRINT "«BAD COMMAND*" 

00050 RETURN 

000 60 "HELLO" 

00070 PRINT "HELLO" : RETURN 

00080 "TEST" 

00090 FOR X=Y TO Z 

00100 PRINT X, 

00110 NEXT X : PRINT : RETURN 

00120 TS=STRING$ (20, "X") 

00130 RETURN 



RUN + 

Object Filespec. 



PGMOVL<CR> 



MEM 

00208 Text 

MEMORY 

00150 Object >==> (size on disk) 
06000 Variable 

QUIT<cr> 

MAIN 

STARTING MAIN PGM 

GOING TO OVERLAY 

IN OVERLAY 

*BAD COMMAND* 

BACK FROM OVERLAY 

HELLO 

1 2 3 4 5 6 7 8 

TS= ' XXXXXXXXXXXXXXXXXXXX • 

Break in 00110 
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ZBasic TRS-80™ Model I, III APPENDIX 



MODE 

ZBasic allows you to utilize different screen modes. The standard mode 
is 64 x 16. The standard graphics are 128 x 48. If you have the Radio 
Shack High resolution graphics board installed in your computer you 
may use modes 8 and higher. 

character = no graphics, uses text instead. 
32 x 16 = expanded characters 

128 x 48 = Regular low resolution graphics 
640 x 240 = Radio Shack High Resolution Board 

or compatible. (Micro-Labs Hi-Res Board.) 

TRS-80 Model I and III 
MODE CHART 



MODE 


TEXT 


GRAPHICS 





32 x 16 


character 


1 


J£"Wx16 


CA tSA x 48 


2 


32 x 16 


character 


3 


3l 14x16 


6H I28rx48 


4 


6V &X16 


character 


5 


64 x 16 


128x48 


6 


CH >5 x1 6 


character 


7 


<£</ *fx16 


128x48 


8 


32 x 16 


640 x 240 


9 


3£4*x16 


640 x 240 


10 


32 x 16 


640 x 240 


11 


2>Z ^ x16 


640 x 240 


12 


4^ 3^x16 


640 x 240 


13 


64 x 16 


640 x 240 


14 


GH 3^x16 


640 x 240 


15 


64 x 16 


640 x 240 
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ADDENDUM 

We inadvertantly forgot to include these predefined user routines under USR in 

the manual (the integer SIN and COS are especially quick). Please insert this 

addendum in the manual at page R-157 

ZBasic Predefined USR functions 

All versions 



USR function 

USR6(expr ) 



Description 

Returns the last line number executed that used any of 
the TRON functions {expr is not used). 



10TRONX 
20 l=USR6(0) 
30 PRINT I 



USR7(expr ) Returns ZBasic's random number seed used in the RND 

function {expr is not used). 

10 FOR 1=1 TO 10 
20 PRINT USR7(0) 
30 NEXT I 



USR8(an<7/e ) Returns the integer sine of angle in the range +/- 255 

(corresponding to +/- 1). The angle must be in brads. 

10 MODE7 :CLS 

20 FOR l=0 TO 255 

30 PLOT l«2,-USR8(l)+384 

40 NEXT I 



\JSR9{angle ) Returns the integer cosine of angle in the range +/- 255 

(corresponding to +/- 1). The angle must be in brads. 



10 MODE7: CLS 

20 FOR 1=0 TO 255 

30 PLOT l«2,-USR9(l)+384 

40 NEXT I 



